home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 701-725 / 707 / rayshade / rs40ami.zoo / ReadMe.Amiga < prev    next >
Text File  |  1992-06-26  |  5KB  |  108 lines
  1.                      Rayshade 4.0 - Amiga release 0.5
  2.  
  3.                                  June 1992
  4.  
  5. This  version of Rayshade for the Amiga has been compiled with SAS/C 5.10b.
  6. It  is  ported  over  from the UNIX version available via anonymous ftp at
  7. weedeater.math.yale.edu (130.132.23.17) in pub/rayshade.4.0.
  8. Rayshade v4.0 was written by Craig Kolb and Rod Bogart during 1990-1991.
  9.  
  10. For documentation refer to rayshade.tex (has to be TeX'ed with troffman.sty
  11. from the tr2tex distribution) or rayshade.man.
  12.  
  13. Raytracing  is  a  very time consuming task, so you should think of setting
  14. the  priority  of  your  cli/shell to -1 with "Changetaskpri -1" before you
  15. start Rayshade.
  16.  
  17.   To  run  rayshade  4.0  PL6  a  stack of at least 100000 bytes is needed.
  18. Larger input files can even need 150000 or 200000 bytes (you can check this
  19. with  Xoper).   The default value of 4000 bytes is not enough and will lead
  20. to  crashes  soon  after the start of rayshade.  To set the stack to 100000
  21. bytes you give the following AmigaDOS command in your shell:
  22.  
  23. stack 100000
  24.  
  25. +==========================================================================+
  26. |    Starting rayshade with a stack setting below 100000 is hazardous !    |
  27. +==========================================================================+
  28.  
  29.   For that reason I have included a checking routine which complains if you
  30. have  less than 100000 bytes stack available during start of rayshade.  The
  31. previous  Amiga  release (0.4) didn't have this checking routine (sorry).
  32.   If  you  have 81000005 gurus during termination of rayshade, the cause is
  33. almost  probably  a  wrong stack setting.  In this case you should increase
  34. your stack using the AmigaDOS "stack" command.
  35.   If you want to know your current stack setting use simply "stack" without
  36. any parameters.
  37.  
  38. Because  I  had  too little spare time to clean up the sources (comment the
  39. changes)  I distribute it as context diffs to the original sources plus the
  40. amiga  specific files.  You can use Patch from fish disk 296 to apply these
  41. patches  to  the  original sources, just type "Patch <diffs" after you have
  42. copied the files in your source directory.
  43.  
  44. If you distribute this program, please distribute it always in complete form:
  45. rs40ami.zoo                Amiga binaries, diffs, makefiles
  46. raysh4PL6.zoo              The original Rayshade 4.0 source, patchlevel 6
  47.  
  48. To generate rayshade for Amiga from the source code you have to do the
  49. following:
  50. 1) unpack raysh4.zoo with zoo 2.1 and "cd" to directory "raysh4"
  51. 2) unpack rs40ami.zoo
  52. 3) "cd rayshade", apply rayshade.diffs with "patch <rayshade.diffs"
  53. 4) "cd" to "libray", apply libray.diffs with "patch -p <libray.diffs"
  54. 5) "cd" to "libshade", apply libshade.diffs with "patch <libshade.diffs"
  55. 6) "cd" to "etc/rsconvert", apply rsconvert.diffs with "patch <rsconvert.diffs"
  56. Now the source code is ready to compile. In every directory there is a makefile
  57. suitable for lmk. The makefiles are named as follows:
  58. makefile         makefile for the plain vanilla 68000 version (FFP math)
  59. makefile.20      makefile for 68020 & FFP version
  60. makefile.881     makefile for 68020 & 68881 version
  61. You will have to build libshade and libray before you can compile rayshade.
  62.  
  63. A  note  to  rsconvert:   You  will have to edit the converted Rayshade 3.0
  64. input  files  and  clean  them  up  before  feeding  it  to  rayshade  4.0.
  65. Furthermore  you  almost  probably  will  have  to  play  around  with  the
  66. parameters  for reflectivity and specular color to avoid the white spots in
  67. your picture.
  68.  
  69. Patch is on AmigaLibDisk 296.
  70. A version of Zoo 2.10 is on AmigaLibDisk 527.
  71.  
  72. The  68020 & 68881 version (you really must have *BOTH* to use it) is named
  73. "Rayshade.881".  This version has been compiled with -m2 and -f8 options.
  74.  
  75. A bug has been fixed since Rel.  0.3:  SAS/C 5.10B doesn't generate correct
  76. code  for  (int)DoubleVar,  the  fix  was  to  use  (int)(floor(DoubleVar))
  77. instead.  This bug was only in the version compiled with -f8 option.
  78.  
  79. ---------------------------------------------------------------------------
  80. rs2fbm  is  a utility for conversion of Rayshade output to FBM format.  FBM
  81. is a image manipulation toolkit for image file format conversion (PCX, IFF,
  82. GIF,  Sun raster files etc.), resizing of images, color quantization and so
  83. on. The Amiga version of fbm is on the fish disks.
  84.  
  85. Usage: rs2fbm [-4] input.rs [output.fbm]
  86.  
  87.        if output.fbm is omitted, then the output is written to stdout.
  88. ---------------------------------------------------------------------------
  89. Rayshade output can be converted to HAM-IFF-images with Hamlab, a shareware
  90. program available on AmigaLibDisk 466.
  91. ---------------------------------------------------------------------------
  92.  
  93. This Rayshade version was ported to the Amiga by:
  94.  
  95. Martin Hohl
  96. Robert-Leicht-Strasse 132
  97. W-7000 Stuttgart 80
  98. F.R. Germany
  99.  
  100. eMail:       martinh@solaris.tynet.sub.org
  101.  
  102.  
  103.                                 DISCLAIMER:
  104. In  no  case  the authors of rayshade will be responsable or liable for any
  105. damages  or  losses  of  data  you might have by using the Amiga version of
  106. Rayshade.   Using  Rayshade  is  at  your own risk.  Since Rayshade is free
  107. software it comes without any warranty.
  108.